Thread-Safety considerations

DataSeries may be modified on any thread; however, the follow thread-safety conditions should be noted.

DataSeries.SyncRoot

DataSeries includes a synchronisation object. All operations such as appending, updating, inserting, removing and clearing the data-series internally lock the DataSeries.SyncRoot.

var xyDataSeries = new XyDataSeries<double,double>();

lock(xyDataSeries.SyncRoot)
{
    // Operate on the DataSeries
    var xRange = xyDataSeries.XRange;
}

DataSeries.SuspendUpdates()

DataSeries can also lock the entire parent chart, preventing redraws or updates until the operation is complete. To achieve this, wrap updates inside a DataSeries.SuspendUpdates() block:

var xyDataSeries = new XyDataSeries<double,double>();

using(xyDataSeries.SuspendUpdates())
{
    // Inside this block, the entire parent chart is locked
       // and cannot redraw
    xyDataSeries.Append(...);
       xyDataSeries.Append(...);
       xyDataSeries.Append(...);
} // One single redraw is performed at the end

Thread Contention with SuspendUpdates

Since DataSeries.SuspendUpdates() locks the parent chart, it should be noted that appending on a background thread and calling SuspendUpdates() frequently actually blocks drawing. It is therefore possible to get a high level of thread contention / blocking using this technique. It should be used sparingly.